home *** CD-ROM | disk | FTP | other *** search
/ ASME's Mechanical Engine…ing Toolkit 1997 December / ASME's Mechanical Engineering Toolkit 1997 December.iso / basic / bas2qb13.lzh / BAS2QB.DOC next >
Text File  |  1987-07-02  |  3KB  |  71 lines
  1. BAS2QB Version 1.3 (6/87)
  2. A QuickBASIC Programmer's Utility
  3. Copyright 1987 By Joe Frankiewicz
  4.  
  5. This program is SHAREWARE. That means if you use it, you should
  6. send in a donation. You'll feel better if you do. (Really).
  7. That also means that you musn't charge a fee for this program.
  8. (And please don't make any alterations to the program or Doc's.)
  9.  
  10. BAS2QB converts a normal BASIC program (saved as an ASCII file)
  11. to a QuickBASIC-type file with unnecessary line numbers removed
  12. and all other line numbers converted to labels. All references
  13. to those line numbers are also changed to labels. The label
  14. consists of the letter 'L' followed by the line number itself.
  15. BAS2QB also makes sure that 'THEN' or 'ELSE' statements followed
  16. by line numbers are changed to 'THEN GOTO' or 'ELSE GOTO'as
  17. required by QuickBASIC.
  18.  
  19. To start the program, type 'BAS2QB' and press [RETURN].
  20.  
  21. When prompted for the INPUT Filename, enter the source file's
  22. drive\path\filename[.ext]. If you do not supply an extension,
  23. .BAS is used by default.  The source file must be a standard
  24. BASIC  program  that  has  been  saved  in  ASCII
  25. format (SAVE'programname',A).
  26.  
  27. When prompted for the OUTPUT Filename, enter the destination
  28. file's drive\path\filename[.ext]  or just press [RETURN] to
  29. use the default filename (shown in brackets). If you do not
  30. supply an extension, .QBS is used by default.
  31.  
  32. The program may also be started in the following manner:
  33.  
  34. BAS2QB source drive\path\filename[.ext] [target drive\path\filename[.ext]]
  35.  
  36. The same defaults will be in effect when starting the
  37. program in this manner.
  38.  
  39. The conversion is a two-pass operation. The source file
  40. will be read in the first pass in order to build a
  41. table of line numbers that are referenced by branching
  42. statements. The following statements are cross-referenced:
  43.  
  44.  GOSUB  RETURN  GOTO  THEN  ELSE  RESTORE  RESUME  RUN
  45.  
  46. If the program was started without filenames on the command
  47. line, the current physical line number and total number of
  48. branching references will be displayed as the file is read.
  49.  
  50. In the second pass, the file is read again. However, in this
  51. pass, the file is copied to the output file, eliminating any
  52. line numbers that are not referenced, and changing those that
  53. are referenced into labels. Each line is then searched for
  54. line numbers and if any are found, they are changed to labels
  55. also. If a 'THEN linenumber' or 'ELSE linenumber'statement
  56. is found, it is converted to 'THEN GOTO linenumber' or 'ELSE
  57. GOTO linenumber' as required by the QuickBASIC compiler.
  58.  
  59. The program will then display the elapsed time and exit
  60. to DOS.
  61.  
  62. Send donations, bug reports, and suggestions to:
  63.  
  64.      Joe Frankiewicz
  65.      1527 Norway #2B
  66.      Palatine, IL 60074
  67.  
  68. Thanks!
  69.  
  70. This program was created with Microsoft QuickBASIC V2.01
  71.